MultiLanguageTextControl

A base input control that supports multi-language text entry and management, enabling localized content handling with event notifications for text changes.

Properties

Name	Description
ContextMenuColumnKey	The key of the column associated with the context menu.
Caption	The caption of the control.
Loading	Indicates whether the control is in a loading state.
MultiLanguageText	Holds the multi-language text content and manages localized text data for the control.
Text	Gets or sets the text content associated with the control.
ControlId	The unique identifier of the control.
Style	The styling properties for the control.
ClientEvents	A list of client-side events associated with the control.
ReadOnly	Gets or sets whether the control is read-only.
ContextMenuTarget	The target of the context menu.
Required	Gets or sets whether the control requires a value for validation.
DefaultReadOnly	Gets or sets the default read-only state of the control.
Title	The title of the control.
ShowCharacterCounter	Determines whether the character counter is displayed for the input field.
MaxLength	Gets or sets the maximum number of characters allowed for the text input.
ExecutedServerEvents	A list of server events that have been executed.
EntityPath	Gets or sets the data path used for binding this control to an entity.
Name	The name of the control.
Value	Gets or sets the current value of the control. The type is defined by the generic parameter TValue.
EnableMultiLanguageText	Indicates whether multi-language text input is enabled.
Visible	Indicates whether the control is visible.
ClientVisible	Indicates whether the control is visible on the client side.
Indexable	Gets or sets whether the control's data is indexable for search and querying.
ServerEvents	A list of server-side events associated with the control.
DefaultClientEnabled	Indicates whether the control is enabled by default on the client side.
ClientReadOnly	Gets or sets whether the control is read-only on the client side, regardless of server state.
ClientEnabled	Indicates whether the control is enabled on the client side.
Enabled	Indicates whether the control is enabled.
Placeholder	Gets or sets the placeholder text for the control, supporting multiple languages.
ContextMenuKey	The key associated with the context menu.
ContainerStyle	The styling properties for the container of the control.
TextAlign	Gets or sets the text alignment within the control.
IsSecretData	Gets or sets a value indicating whether the text input should be treated as secret data (e.g., masked or encrypted).
CustomClassName	The custom CSS class name applied to the control.
Size	Gets or sets the layout size configuration for the control.
DefaultEnabled	Indicates whether the control is enabled by default.
TabIndex	Gets or sets the tab order index for the control.

Constructors

Name	Description
BaseControl()	Initializes a new instance of the MultiLanguageTextControl class with default values.
MultiLanguageTextControl()	Initializes a new instance of the MultiLanguageTextControl class with default settings and binds text and multi-language events.
MultiLanguageTextControl()	Initializes a new instance of the MultiLanguageTextControl class with default placeholder text and left-aligned text.
MultiLanguageTextControl()	Initializes a new instance of the MultiLanguageTextControl class with empty event lists.
MultiLanguageTextControl()	Initializes a new instance of the MultiLanguageTextControl class with default values for MaxLength and IsSecretData, and binds the DataLoad event.

Methods

Name	Description
ScrollTo()	Scrolls to the control.
HideLoading()	Removes the loading state from the control.
OnTextChanged(sender, e)	Raises the TextChanged event after the text property has been updated.
FireClick()	Triggers the Click event.
OnInit(sender, e)	Raises the Init event.
GetDifferences(otherObj)	Compares the current instance with another control and returns property differences, including placeholder and text alignment.
Hide()	Hides the control.
OnPropertyValueGet(sender, e)	Raises the PropertyValueGet event.
Show()	Makes the control visible.
Equals(other)	Determines whether the specified MultiLanguageTextControl is equal to the current control.
SetValueAsObject(value)	Sets the internal multi-language text using a dictionary of language-text pairs.
OnMultiLanguageTextChanged(sender, e)	Raises the MultiLanguageTextChanged event after the multi-language text has been changed.
OnDataLoad(sender, e)	Raises the DataLoad event with the provided arguments.
OnRender(sender, e)	Raises the Render event.
OnLoad(sender, e)	Raises the Load event.
OnValueChanging(sender, e)	Raises the ValueChanging event with the provided arguments and attaches metadata to the event output.
GetProtectedData(isDisabledOrReadOnly)	#import (Bimser.CSP.FormControls.Base.ICanProtectData.GetProtectedData(bool)) (shortDescription)
RemoveText()	Removes the current text content from the control.
ToggleLoading()	Toggles the loading state of the control.
GetDifferences(otherObj)	Compares the current instance with another control and returns the differences.
SetPropertyValue(mapping, value)	Sets the value of a property specified by a mapping.
ClearDefaultValue()	Clears the control’s default value. Can be overridden in derived classes.
LoadData(sender, e)	Loads the given data into the control by assigning it to both the Text and Value properties.
OnValueChanged(sender, e)	Raises the ValueChanged event with the provided arguments.
OnMultiLanguageTextChanging(sender, e)	Raises the MultiLanguageTextChanging event before the multi-language text is changed.
OnPropertyChanged(sender, e)	Handles the property changed event.
GetValueAsObject()	Gets the current value of the control as a generic object. Override to return meaningful data in derived types.
ShowLoading()	Sets the control to a loading state.
OnPreRender(sender, e)	Raises the PreRender event.
GetDifferences(otherObj)	Compares the current control with another and returns a dictionary of differences.
Equals(obj)	Determines whether the specified object is equal to the current control.
OnValidating(sender, e)	Raises the Validating event with the provided arguments.
OnTextChanging(sender, e)	Raises the TextChanging event with the given arguments and attaches change metadata.
OnPropertyChanging(sender, e)	Handles the property changing event.
SetText(text)	Sets the text content of the control.
RemoveAll()	Removes all editable content from the control.
OnDoubleClick(sender, e)	Raises the DoubleClick event.
GetData()	Gets the control’s current data, including type, text, and value, as a structured object.
IsValid()	Returns a value indicating whether the control’s current value is valid.
OnClick(sender, e)	Raises the Click event.
GetText()	Returns the current text value of the control.
GetHashCode()	Returns a hash code for the current control instance.

Events

Name	Description
Validating	Raised before the control's value is validated.
Init	Triggered when the control is initialized.
Load	Triggered when the control is loaded.
TextChanged	Raised after the Text property has been changed.
ValueChanged	Raised after the value of the control has changed.
DoubleClick	Triggered when the control is double-clicked.
LazyLoading	Raised when the control initiates a lazy-loading operation to fetch additional data.
MultiLanguageTextChanged	Triggered after the multi-language text has been changed.
PreRender	Triggered before the control is rendered.
PropertyValueGet	Triggered when retrieving a control property value.
Click	Triggered when the control is clicked.
MultiLanguageTextChanging	Triggered before the multi-language text is changed.
DataLoad	Raised when external data is loaded into the control.
ValueChanging	Raised before the value of the control is changed.
Render	Triggered when the control is rendered.
TextChanging	Raised before the Text property is changed.

Generic Types

Name	Description
TValue	Represents the value type handled by the input control.
TEventValue	Represents the type used in value change events for the input control.